home *** CD-ROM | disk | FTP | other *** search
/ Info-Mac 4 / Info_Mac IV CD-ROM (Pacific HiTech Inc.)(August 1994).iso / Science / GesSpectreƒ / GesSpectre Readme < prev    next >
Encoding:
Text File  |  1994-05-26  |  7.6 KB  |  128 lines  |  [ttro/ttxt]

  1.  
  2.  
  3.                                             ******************
  4.                                             *     GesSpectre  V6   *
  5.                                             ******************
  6.                                                           May 94
  7.                              Nuclear spectra processing on Macintosh
  8.  
  9.                                            H.P. Garnir & F.S. Monjoie
  10.            University of Liège, I.P.N.E. Sart Tilman B15, B-4000 Liège, Belgium 
  11.                                                Tel: (32) 41-563690
  12.              E-mail : garnir@gw.unipc.ulg.ac.be & fmonjoie@vm1.ulg.ac.be
  13.  
  14.  
  15. GesSpectre visualises and analyses spectra obtained from nuclear particle detectors. It emulates the display of a multi channel analyser (MCA). The acquisition is made by in an external ADC connected to the Macintosh through a serial RS422 line or with a direct connection to an ADC via a PIA interface. Data can also be read from text files. It is specially oriented to PIXE (Particle Induced X-ray Emission) spectra.
  16.  
  17.  
  18. •Up to 9 spectra may be viewed independently and simultaneously in windows.
  19. •Each window has all the Mac usual controls (elevators, grow box, zoom box, etc.).
  20. •The start and stop of an acquisition are controlled by the program and the spectra accumulated in an external device are quickly transferred to memory. Direct connection to an ADC is supported with real time display. All activities are available during acquisitions. 
  21. •Each spectrum can be saved in fast compact binary format or as text file.
  22. •Parametric calibration (2nd order) is calculated individually for each spectra.
  23. •Regions of interest (R.O.I.) may be defined anywhere in the spectrum (using only the mouse) and their characteristics instantly presented on the screen. (With a B/W monitor the R.O.I. are presented in bold.)
  24. •On request, the characteristics of the R.O.I. (position, surface, background etc.) are accumulated under a table format, which may be printed, saved on disk (as a “tab separated text file”) or directly transferred into the clipboard (under an Excel™ compatible format).
  25. •The spectrum graphic image may be copied into the clipboard (to be printed or included in a report) 
  26. •Automatic processing may be done by creating a "Macro" (a list of commands that could be replayed automatically) and, with the adequate hardware, a sample changer may be controlled. 
  27. The program works only with System 7 (or up) and fully conforms to the Macintosh interface. It is written in Think Pascal™ (V4.02) and occupies about 200 kbytes. Pascal sources may be obtained on request.
  28.  
  29.                                                  _______________
  30.  
  31.                                        EXCERPT FROM THE USER MANUAL
  32.  
  33. *****MOUSE USAGE
  34.  
  35. Single click 
  36.  -above the X axis: move the cursor to the click position,
  37.  -below the X axis: toggle the zoom ON/OFF.
  38. Double click
  39. Near a maximum or in a ROI: 
  40.  -move the cursor to the maximum,
  41.  -if not a ROI, make a one channel width ROI,
  42.  -beep and display the ROI info in the lower right corner.
  43. Away from a maximum (on a slope e.g.): beep!
  44. Click-drag
  45.  -from left to right: mark the underlying channels (define a ROI).
  46.  -from right to left: remove the mark (erase a ROI).
  47.  
  48.  
  49. *****KEYBOARD SHORTCUTS
  50. Arrows
  51.  <Left arrow>: move cursor 1 channel to the left.
  52.  <Right arrow>: move cursor 1 channel to the right.
  53.  <Opt>-<left arrow>: cursor to right channel of previous ROI (also < and w).
  54.  <Opt>-<right arrow>: cursor to left channel of next ROI ( also > and W ).
  55.        (if autoscale is on, the Y scale is adjusted on the ROI limits (not maximum).
  56.  <Cmd>-<left arrow>: slide spectra half screen to the left.
  57.  <Cmd>-<right arrow>: slide spectra half screen to the right.
  58.  <Opt>-<Cmd>-<left arrow>: display peak info of previous ROI and move cursor on it.
  59.  <Opt>-<Cmd>-<right arrow>: display peak info of next ROI and move cursor on it .
  60. If necessary, readjust viewing area by sliding the spectra left of right.
  61.  <Down arrow>: reduce Y scale.
  62.  <Up arrow>: increase Y scale.
  63. Other keys
  64.  <Space>: adjust Y scale to full scale (during acquisition: twice full scale).
  65.  <Enter>: scan ROI and display Peak info (same as: <Opt>-<Cmd>-<right arrow>).
  66.  <Tab>: activate next window.
  67.  <Esc>: close active window.
  68.  <Ctrl>-G: Special beep test.
  69.  
  70. N.B. :In the comment dialog box of the spectra info window \r is transformed in a <return>.
  71.  
  72. *****HOW TO CALIBRATE A SPECTRUM?
  73.  
  74. 0.- Clear all ROI (<Cmd>-K).
  75. 1.- Select with the mouse some ROI of known energy (min. 1, max. 8).
  76. 2.- Choose “Calibration…” in the “Processing” menu.
  77. 3.- Replace each proposed value by its exact energy value.
  78. 4.- Click OK to calculate the best second order calibration curve of the type 
  79.  ax^2 + b x + c. 
  80. 5.- The a, b, c values may be read (or changed) in the “Spectra Info dialog” (cf. display menu).
  81.  
  82.  
  83. *****THE MACRO COMMANDS
  84.  
  85. Each macro command is formed by 3 uppercase letters. The commands have to be written in one sentence. There are 13 commands. The two last ones must be followed be a numerical parameter. 
  86.  
  87. STA Start an acquisition.
  88. STO Stop an acquisition.
  89. ZER Zero the data (on the display and in the ADC buffer).
  90. COP Copy a report into the clipboard.
  91. SAV Save the spectra on disk.
  92. INC Increment the name of the spectra.
  93. PRI Print a report on paper.
  94. TOE Save a report on disk under an Excel™ compatible format.
  95. WAI Wait until the end of an acquisition (preset time or external signal)
  96.  OR the end of a step motor displacement.
  97. SMO Smoothing.
  98. TUU Produce a loud beep.
  99. MOV±nnn Move the step motor ±nnn steps (relatively to the actual position).
  100. CYCnnn Recycle the whole Macro from the start nnn times.
  101.  
  102. •Example:
  103. ZERINCSTAWAISAVTOECYC5MOV-1000CYC10
  104. Repeat 10 times: { Repeat 5 times: { Zero, Increment name, start acq., wait till the end, save data on disk (binary format), save an Excel report file} Move relatively -1000 steps}
  105.  
  106.  
  107.  
  108.                                                          ____________
  109.  
  110.                               NOTE ON THE EXTERNAL ACQUISITION HARDWARE
  111.  
  112. By default, the acquisition in GesSpectre is in DEMO MODE. The preference… menu allows to activate another mode:
  113. A.- SERIAL LINK (a.g. Canberra S20 or S35) on modem or printer port.
  114. Bidirectional RS-232 link between the Mac and the ADC box, 8 bits, 9600 bauds (S20) or 19200 (S35), X-on/X-Off protocol.
  115. -A change of the state of the DTR input line stops a running acquisition (external stop).
  116. -On start, the DTR output line flips (to remote control an external apparatus).
  117.  
  118. B.- Parallel Interface Adaptor (NuBus or PDA) (Cheep — no memory box needed!)
  119. The data lines of the ADC are directly connected to the PIA. During an acquisition, the ADC “pilot signal” activates an interrupt process which reads the result of the conversion from the data line, resets the ADC and increments the designated channel (50% dead time for a counting rate of ≈ 6000 cps on a LC). At low counting rate, the display is updated at every count in real time (this is very useful for low counting rate signal observation).
  120. Some spare lines of the PIA are used to:
  121.     -control an external counter: pulse at start,
  122.     -move a step motor: one line gives rectangular pulses (max 400 Hz), an other, the direction. During the move, all functions are still active.
  123.     -controlling a DAC to change the magnet current.
  124. •GesSpectre works with some National Instruments cards and we have developed a cheap  "home made" PDA card for LC and colour classic. (This make a cheap MCA for student lab a.e.) More info on request.
  125.  
  126.                                                     ••Caution••
  127. On  (old) 68040 Mac, the check for the card is not working and hang the computer when there is no card. (If you did activate the check, you can get out by holding down the option key during boot-up and disabling the option in the preference menu!) 
  128.